package com.hiveway.controller.admin;

import com.hiveway.dto.OrdersCancelDTO;
import com.hiveway.dto.OrdersConfirmDTO;
import com.hiveway.dto.OrdersPageQueryDTO;
import com.hiveway.dto.OrdersRejectionDTO;
import com.hiveway.result.PageResult;
import com.hiveway.result.Result;
import com.hiveway.service.OrderService;
import com.hiveway.vo.OrderStatisticsVO;
import com.hiveway.vo.OrderVO;
import io.swagger.annotations.Api;
import io.swagger.annotations.ApiOperation;
import lombok.extern.slf4j.Slf4j;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.web.bind.annotation.*;

@RestController
@RequestMapping("/admin/order")
@Api(tags = "订单相关接口")
@Slf4j
public class OrderController {

    @Autowired
    private OrderService orderService;

    /**
     * 订单分页条件搜索接口
     *
     * @param ordersPageQueryDTO 订单分页查询条件对象，包含以下字段：
     *        - page: 当前页码
     *        - pageSize: 每页记录数
     *        - number: 订单号（可选）
     *        - phone: 联系电话（可选）
     *        - status: 订单状态（可选）
     *        - beginTime: 开始时间（可选）
     *        - endTime: 结束时间（可选）
     * @return Result<PageResult> 包含分页查询结果的响应对象：
     *         - data: 分页结果数据对象，包含：
     *             - total: 总记录数
     *             - records: 当前页数据列表
     *         - code: 响应状态码
     *         - msg: 响应消息
     */
    @GetMapping("/conditionSearch")
    @ApiOperation("订单搜索")
    public Result<PageResult> conditionSearch(OrdersPageQueryDTO ordersPageQueryDTO) {
        log.info("订单搜索");
        // 调用服务层进行条件查询并返回分页结果
        PageResult pageResult = orderService.conditionSearch(ordersPageQueryDTO);
        return Result.success(pageResult);
    }


    /**
     * 各个状态的订单数量统计
     *
     * 调用订单服务层获取订单状态统计信息，封装为统一响应格式返回。
     * 统计维度包含待接单/待派送/派送中/已完成/已取消等订单状态数量
     *
     * @return Result<OrderStatisticsVO> 统一响应实体，包含：
     *         - 订单状态统计VO对象（各状态订单数量及分类统计）
     *         - 状态码及消息标识
     */
    @GetMapping("statistics")
    @ApiOperation("各个状态的订单数量统计")
    public Result statistics() {
        // 记录业务操作日志
        log.info("各个状态的订单数量统计");

        // 调用服务层获取统计结果
        OrderStatisticsVO orderStatisticsVO = orderService.statistics();

        // 封装统一响应格式
        return Result.success(orderStatisticsVO);
    }


    /**
     * 根据订单ID查询订单详细信息
     *
     * @param id 订单唯一标识符，通过URL路径传递
     * @return 包含订单详细信息的统一响应对象，数据封装在OrderVO中。
     *         响应结构：{
     *             code: 状态码,
     *             msg: 操作说明,
     *             data: {
     *                 // 订单主体信息
     *                 id: 订单ID,
     *                 orderTime: 下单时间,
     *                 // 其他订单相关字段...
     *                 orderDishes: [订单菜品明细列表]
     *             }
     *         }
     */
    @GetMapping("/details/{id}")
    @ApiOperation("查询订单详情")
    public Result<OrderVO> details(@PathVariable Long id) {
        // 记录订单查询日志
        log.info("查询订单详情：{}", id);

        // 调用服务层获取订单详情
        OrderVO orderVO = orderService.details(id);

        // 封装响应结果
        return Result.success(orderVO);
    }


    /**
     * 接单
     *
     * @return
     */
    @PutMapping("/confirm")
    @ApiOperation("接单")
    public Result confirm(@RequestBody OrdersConfirmDTO ordersConfirmDTO) {
        log.info("接单");
        orderService.confirm(ordersConfirmDTO);
        return Result.success();
    }

    /**
     * 拒单接口方法，用于处理订单的拒单操作。
     *
     * @param ordersRejectionDTO 包含拒单相关信息的数据传输对象（DTO），例如订单ID、拒单原因等。
     *                           该参数通过请求体传递，必须符合 OrdersRejectionDTO 的数据结构。
     * @return 返回一个 Result 对象，表示操作结果。如果拒单成功，则返回成功的 Result 对象。
     *
     * 功能描述：
     * 1. 接收前端传递的拒单信息；
     * 2. 调用 orderService 的 rejection 方法执行具体的拒单逻辑；
     * 3. 返回操作结果给前端。
     */
    @PutMapping("/rejection")
    @ApiOperation("拒单")
    public Result rejection(@RequestBody OrdersRejectionDTO ordersRejectionDTO) {
        // 记录拒单操作的日志信息
        log.info("拒单");

        // 调用服务层方法处理拒单逻辑
        orderService.rejection(ordersRejectionDTO);

        // 返回成功的结果
        return Result.success();
    }


    /**
     * 取消订单
     *
     * 该方法用于处理取消订单的请求。它接收一个包含订单取消信息的数据传输对象（DTO），
     * 调用订单服务的取消方法执行取消操作，并返回操作结果。
     *
     * @param ordersCancelDTO 包含订单取消相关信息的DTO对象，例如订单ID、取消原因等。
     *                        该参数通过请求体传递，必须符合OrdersCancelDTO的结构定义。
     *
     * @return 返回一个Result对象，表示操作结果。如果取消成功，返回成功的Result对象。
     */
    @PutMapping("/cancel")
    @ApiOperation("取消订单")
    public Result cancel(@RequestBody OrdersCancelDTO ordersCancelDTO) {
        // 调用订单服务的取消方法，传入订单取消DTO以执行取消逻辑
        orderService.cancel(ordersCancelDTO);

        // 返回成功的操作结果
        return Result.success();
    }


    /**
     * 派送订单
     *
     * 该方法用于处理订单派送的请求。通过指定的订单ID，调用服务层的方法完成订单派送操作，
     * 并返回操作结果。
     *
     * @param id 订单的唯一标识符，用于定位需要派送的订单。
     * @return 返回一个Result对象，表示操作的结果。如果派送成功，则返回成功的Result对象。
     */
    @PutMapping("/delivery/{id}")
    @ApiOperation("派送订单")
    public Result delivery(@PathVariable Long id) {
        // 记录日志，输出当前派送的订单ID，便于后续追踪和调试
        log.info("派送订单：{}", id);

        // 调用订单服务的派送方法，完成订单派送逻辑
        orderService.deliveryOrder(id);

        // 返回操作成功的Result对象
        return Result.success();
    }


    /**
     * 完成指定ID的订单。
     *
     * @param id 订单的唯一标识符，通过路径变量传递。
     *           该参数用于定位需要完成的订单。
     * @return 返回一个Result对象，表示操作结果。
     *         如果订单完成成功，则返回成功的Result对象。
     */
    @PutMapping("/complete/{id}")
    @ApiOperation("完成订单")
    public Result complete(@PathVariable Long id){
        // 记录日志，输出当前完成的订单ID，便于调试和追踪。
        log.info("完成订单：{}", id);

        // 调用订单服务完成订单，具体逻辑由orderService实现。
        orderService.completeOrder(id);

        // 返回操作成功的Result对象。
        return Result.success();
    }

}
